NOMBRE¶

manpath - formato del fichero /etc/man_db.conf

DESCRIPCIÓN¶

El fichero de configuración de rutas de manual se usa por los útiles de las páginas de manual para obtener las rutas a los manuales para cada usuario a la hora de ejecutar dichos útiles, para indicar que jerarquías de páginas de manuales (rutas a los manuales o "manpaths") se deben tratar como `globales' y para asignarles directorios a usar para almacenar los ficheros cat.

Si la variable de entorno $MANPATH ya ha sido definida, la información contenida en /etc/man_db.conf no tendrá precedencia sobre ella.

FORMATO¶

Los siguientes tipos de campo estan reconocidos actualmente:

# comentario

Las líneas en blanco o las que comienzan con # serán tratadas como comentarios y no serán procesadas.

MANDATORY_MANPATH elemento_de_ruta_de_manual

Las líneas de esta forma indican rutas de manual que cualquier $MANPATH generado automáticamente debe contener. Esto incluirá típicamente /usr/man.

MANPATH_MAP elemento_de_ruta elemento_de_ruta_de_manual

Las líneas de esta forma definen las correspondencias entre $PATH y $MANPATH. Para cada elemento_de_ruta que se encuentre en el $PATH del usuario, se añadira elemento_de_ruta_de_manual al $MANPATH.

MANDB_MAP elemento_de_ruta_de_manual [ elemento_de_ruta_de_cat ]

Las líneas de esta forma indican qué rutas de manual se deben tratar como `globales' y opcionalmente, donde se deben almacenar sus ficheros cat. Este tipo de fichero es particularmente importante si man es un programa setuid, ya que esto indica cuáles jerarquías de páginas de manual se deben acceder como el usuario setuid y cuáles como el usuario que ejecuta el programa.

Las jerarquías de páginas de manual `globales' suelen ser aquellas almacenadas bajo /usr como /usr/man, /usr/local/man y /usr/X11R6/man.

Si las páginas cat de un elemento_de_ruta_de_manual no deben ser almacenadas, o se deben almacenar en su lugar tradicional, elemento_de_ruta_de_cat puede omitirse.

El almacenamiento en el lugar tradicional para cat puede ser imposible para jerarquías de páginas de manual montadas para sólo lectura, y a causa de esto es posible especificar cualquier jerarquía de directorios válida para su almacenamiento. Para cumplir el FSSTND de Linux la palabra clave `FSSTND' puede usarse en lugar de un directorio real.

Desafortunadamente, es necesario especificar todas las rutas `globales' del árbol de rutas de manual, incluyendo las rutas para sistemas alternativos como /usr/man/sun y cualesquiera rutas para NLS locale como /usr/man/de_DE.88591.

Como la información se procesa línea a línea en el orden en que fue escrita, es necesario que cualquier ruta de manual que sea una subjerarquía de otra jerarquía aparezca primero en el listado, de otro modo se asociarán de forma incorrecta. Un ejemplo es que /usr/man/de_DE.88591 debe aparecer primero que /usr/man.

BUGS¶

A menos que las reglas descritas se sigan estrictamente, los útiles para las páginas de manual no funcionarán como se desea. Las reglas son muy complicadas.